<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.0 Transitional//EN">
<html>
<head>
<link rel="STYLESHEET" href="lib.css" type='text/css' />
<link rel="SHORTCUT ICON" href="../icons/pyfav.png" type="image/png" />
<link rel='start' href='../index.html' title='Python documentation Index' />
<link rel="first" href="lib.html" title='Python library Reference' />
<link rel='contents' href='contents.html' title="Contents" />
<link rel='index' href='genindex.html' title='Index' />
<link rel='last' href='about.html' title='About this document...' />
<link rel='help' href='about.html' title='About this document...' />
<link rel="next" href="node424.html" />
<link rel="prev" href="node422.html" />
<link rel="parent" href="module-logging.html" />
<link rel="next" href="node424.html" />
<meta http-equiv="Content-Type" content="text/html; charset=utf-8" />
<meta name='aesop' content='information' />
<title>14.5.8 LogRecord Objects</title>
</head>
<body>
<div class="navigation">
<div id='top-navigation-panel' xml:id='top-navigation-panel'>
<table align="center" width="100%" cellpadding="0" cellspacing="2">
<tr>
<td class='online-navigation'><a rel="prev" title="14.5.7 filter Objects"
  href="node422.html"><img src='../icons/previous.png'
  border='0' height='32'  alt='Previous Page' width='32' /></a></td>
<td class='online-navigation'><a rel="parent" title="14.5 logging  "
  href="module-logging.html"><img src='../icons/up.png'
  border='0' height='32'  alt='Up one Level' width='32' /></a></td>
<td class='online-navigation'><a rel="next" title="14.5.9 thread Safety"
  href="node424.html"><img src='../icons/next.png'
  border='0' height='32'  alt='Next Page' width='32' /></a></td>
<td align="center" width="100%">Python Library Reference</td>
<td class='online-navigation'><a rel="contents" title="Table of Contents"
  href="contents.html"><img src='../icons/contents.png'
  border='0' height='32'  alt='Contents' width='32' /></a></td>
<td class='online-navigation'><a href="modindex.html" title="Module Index"><img src='../icons/modules.png'
  border='0' height='32'  alt='Module Index' width='32' /></a></td>
<td class='online-navigation'><a rel="index" title="Index"
  href="genindex.html"><img src='../icons/index.png'
  border='0' height='32'  alt='Index' width='32' /></a></td>
</tr></table>
<div class='online-navigation'>
<b class="navlabel">Previous:</b>
<a class="sectref" rel="prev" href="node422.html">14.5.7 Filter Objects</a>
<b class="navlabel">Up:</b>
<a class="sectref" rel="parent" href="module-logging.html">14.5 logging  </a>
<b class="navlabel">Next:</b>
<a class="sectref" rel="next" href="node424.html">14.5.9 Thread Safety</a>
</div>
<hr /></div>
</div>
<!--End of Navigation Panel-->

<h2><a name="SECTION0016580000000000000000">
14.5.8 LogRecord Objects</a>
</h2>

<p>
<tt class="class">LogRecord</tt> instances are created every time something is logged. They
contain all the information pertinent to the event being logged. The
main information passed in is in msg and args, which are combined
using msg % args to create the message field of the record. The record
also includes information such as when the record was created, the
source line where the logging call was made, and any exception
information to be logged.

<p>
<dl><dt><table cellpadding="0" cellspacing="0"><tr valign="baseline">
  <td><nobr><b><span class="typelabel">class</span>&nbsp;<tt id='l2h-2961' xml:id='l2h-2961' class="class">LogRecord</tt></b>(</nobr></td>
  <td><var>name, lvl, pathname, lineno, msg, args,
                             exc_info </var><big>[</big><var>, func</var><big>]</big><var></var>)</td></tr></table></dt>
<dd>
Returns an instance of <tt class="class">LogRecord</tt> initialized with interesting
information. The <var>name</var> is the logger name; <var>lvl</var> is the
numeric level; <var>pathname</var> is the absolute pathname of the source
file in which the logging call was made; <var>lineno</var> is the line
number in that file where the logging call is found; <var>msg</var> is the
user-supplied message (a format string); <var>args</var> is the tuple
which, together with <var>msg</var>, makes up the user message; and
<var>exc_info</var> is the exception tuple obtained by calling
<tt class="function">sys.exc_info() </tt>(or <tt class="constant">None</tt>, if no exception information
is available). The <var>func</var> is the name of the function from which the
logging call was made. If not specified, it defaults to <var>None</var>.

<span class="versionnote">Changed in version 2.5:
<var>func</var> was added.</span>

</dl>

<p>
<dl><dt><table cellpadding="0" cellspacing="0"><tr valign="baseline">
  <td><nobr><b><tt id='l2h-2962' xml:id='l2h-2962' class="method">getMessage</tt></b>(</nobr></td>
  <td><var></var>)</td></tr></table></dt>
<dd>
Returns the message for this <tt class="class">LogRecord</tt> instance after merging any
user-supplied arguments with the message.
</dl>

<p>

<div class="navigation">
<div class='online-navigation'>
<p></p><hr />
<table align="center" width="100%" cellpadding="0" cellspacing="2">
<tr>
<td class='online-navigation'><a rel="prev" title="14.5.7 filter Objects"
  href="node422.html"><img src='../icons/previous.png'
  border='0' height='32'  alt='Previous Page' width='32' /></a></td>
<td class='online-navigation'><a rel="parent" title="14.5 logging  "
  href="module-logging.html"><img src='../icons/up.png'
  border='0' height='32'  alt='Up one Level' width='32' /></a></td>
<td class='online-navigation'><a rel="next" title="14.5.9 thread Safety"
  href="node424.html"><img src='../icons/next.png'
  border='0' height='32'  alt='Next Page' width='32' /></a></td>
<td align="center" width="100%">Python Library Reference</td>
<td class='online-navigation'><a rel="contents" title="Table of Contents"
  href="contents.html"><img src='../icons/contents.png'
  border='0' height='32'  alt='Contents' width='32' /></a></td>
<td class='online-navigation'><a href="modindex.html" title="Module Index"><img src='../icons/modules.png'
  border='0' height='32'  alt='Module Index' width='32' /></a></td>
<td class='online-navigation'><a rel="index" title="Index"
  href="genindex.html"><img src='../icons/index.png'
  border='0' height='32'  alt='Index' width='32' /></a></td>
</tr></table>
<div class='online-navigation'>
<b class="navlabel">Previous:</b>
<a class="sectref" rel="prev" href="node422.html">14.5.7 Filter Objects</a>
<b class="navlabel">Up:</b>
<a class="sectref" rel="parent" href="module-logging.html">14.5 logging  </a>
<b class="navlabel">Next:</b>
<a class="sectref" rel="next" href="node424.html">14.5.9 Thread Safety</a>
</div>
</div>
<hr />
<span class="release-info">Release 2.5.1, documentation updated on 18th April, 2007.</span>
</div>
<!--End of Navigation Panel-->
<address>
See <i><a href="about.html">About this document...</a></i> for information on suggesting changes.
</address>
</body>
</html>
